Este artigo foi elaborado para ajudar você a criar um totalmente novo. Para saber como criar e testar rapidamente uma demonstração do criada pelo GitHub, confira Início Rápido das Extensões do GitHub Copilot usando agentes.
Conjuntos de habilidades e agentes são as duas maneiras de estender as funcionalidades e o contexto do Copilotpor meio do . Eles permitem que você integre serviços externos e APIs ao , mas cada um deles atende a diferentes casos de uso e oferece diferentes níveis de controle e complexidade:
- Conjuntos de habilidades são leves e simplificados, projetados para desenvolvedores que precisam do Copilot para executar tarefas específicas (por exemplo, recuperação de dados ou operações simples) com configuração mínima. Eles lidam com roteamento, criação de prompts, avaliação de função e geração de resposta automaticamente, tornando-os ideais para integrações rápidas e simples. Para obter mais informações sobre conjuntos de habilidades, confira Sobre os conjuntos de habilidades do Copilot.
- Agentes são para integrações complexas que precisam de controle total sobre como as solicitações são processadas e as respostas são geradas. Eles permitem que você implemente a lógica personalizada, integre-se a outras LLMs e/ou à API do Copilot, gerencie o contexto da conversa e lide com todos os aspectos da interação do usuário. Embora os Agentes exijam mais engenharia e manutenção, eles oferecem flexibilidade máxima para fluxos de trabalho sofisticados. Para saber mais sobre agentes, confira Sobre os agentes do Copilot.
1. Saiba mais sobre o
Os contêm o código personalizado para sua e se integram a um GitHub App para formar a própria . Para saber mais, confira Sobre os agentes do Copilot.
Para construir um de forma bem-sucedida, você precisa entender como o agente se comunica com:
- A plataforma Copilot usando eventos enviados pelo servidor. Confira Configurar o agente do Copilot para se comunicar com a plataforma Copilot.
- A API GitHub. Confira Configurar o agente do Copilot para se comunicar com o GitHub.
2. Revise o exemplo de e o SDK das
Para ver os conceitos anteriores na prática e saber mais sobre implementações de agentes, revise os seguintes agentes de exemplo e o SDK (Software Development Kit), todos disponíveis na organização copilot-extensions:
- Blackbeard (melhor ponto de partida): um agente simples que responde a solicitações como um pirata usando a API do grande modelo de linguagem (LLM) do Copilot e prompts do sistema especiais.
- GitHub Models: um agente mais complexo que permite perguntar e interagir com vários LLMs listados no GitHub Marketplace via . O agente GitHub Models usa o recurso de chamada de função.
- Chamada de função: um agente de exemplo escrito em Go que demonstra caixas de diálogo de confirmação e chamada de função.
- Extensão RAG: um agente de exemplo escrito em Go que demonstra uma implementação simples de geração aumentada de recuperação.
- SDK de visualização: um SDK que simplifica o desenvolvimento de manipulando a verificação de solicitação, a análise de payloads e a formatação automática de resposta. Esse SDK permite que os criadores de extensões se concentrem mais na criação de funcionalidades principais e menos em código clichê.
3. Crie um
Usando o material de referência das etapas anteriores, planeje e crie seus . Você pode optar por implementar uma das seguintes opções:
- Para evitar a criação e o gerenciamento de sua própria implantação de LLM, seu agente pode chamar a implantação do Copilot LLM. Confira Usar o LLM do Copilot para seu agente.
- Para interpretar rapidamente a entrada do usuário e escolher entre uma variedade de funções predefinidas a serem executadas, você pode implementar a chamada de função em seu agente. Para saber mais, consulte Como usar a chamada de função com o Serviço OpenAI do Azure na documentação do OpenAI do Azure e Chamada de função na documentação do OpenAI.
4. Implante seu
Para tornar seu acessível à plataforma Copilot e ao GitHub, você precisa implantá-lo em um servidor que possa ser acessado por solicitação HTTP. Confira Configurando o servidor para hospedar a extensão do Copilot.
5. Crie um GitHub App e integre-o ao seu
Para criar uma , você precisa criar e configurar um GitHub App e, em seguida, integrá-lo ao seu . Confira Criar um aplicativo GitHub para sua extensão do Copilot e Configurar o Aplicativo GitHub para a extensão do Copilot.
6. Escolha a disponibilidade da sua
Escolha um dos dois níveis de visibilidade para sua :
- Pública: qualquer conta de usuário ou organização com o link da página de instalação da extensão pode instalá-la.
- Privada: somente a conta de usuário ou organização que criou a extensão pode instalá-la.
Se a for pública, talvez você queira listá-la no GitHub Marketplace.
Para saber como alterar a visibilidade da seu e listá-lo no GitHub Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Próximas etapas
Para saber como usar sua , confira Usando extensões para integrar ferramentas externas ao Copilot Chat.
1. Saiba mais sobre
Os contêm o código personalizado para sua e se integram a um GitHub App para formar a própria .
Diferente do , os lidam com a lógica por trás da criação de prompt, avaliação de função e geração de resposta, tornando-os uma opção ideal para desenvolvedores que buscam integrações rápidas e eficazes com esforço mínimo. Para saber mais, confira Sobre os conjuntos de habilidades do Copilot.
2. Criar um
Para explorar um exemplo de implementação de conjunto de habilidades, consulte o repositório skillset-example na organização copilot-extensions.
Para criar um conjunto de habilidades, confira Criando conjuntos de habilidades do Copilot.
3. Implantar seu
Para tornar seu acessível à plataforma Copilot e ao GitHub, você precisa implantá-lo em um servidor que possa ser acessado por solicitação HTTP. Confira Configurando o servidor para hospedar a extensão do Copilot.
4. Criar um GitHub App e integre-o ao seu
Para criar uma , você precisa criar e configurar um GitHub App e, em seguida, integrá-lo ao seu . Confira Criar um aplicativo GitHub para sua extensão do Copilot e Configurar o Aplicativo GitHub para a extensão do Copilot.
5. 6. Escolha a disponibilidade da sua
Escolha um dos dois níveis de visibilidade para sua :
- Pública: qualquer conta de usuário ou organização com o link da página de instalação da extensão pode instalá-la.
- Privada: somente a conta de usuário ou organização que criou a extensão pode instalá-la.
Se a for pública, talvez você queira listá-la no GitHub Marketplace.
Para saber como alterar a visibilidade da seu e listá-lo no GitHub Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Próximas etapas
Para saber como usar sua , confira Usando extensões para integrar ferramentas externas ao Copilot Chat.